<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>set_params_class_knn [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_classification.html">分类</a> / <a href="toc_classification_knearestneighbor.html">K-最近邻</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">set_params_class_knn</span><span data-if="c" style="display:none;">T_set_params_class_knn</span><span data-if="cpp" style="display:none;">SetParamsClassKnn</span><span data-if="dotnet" style="display:none;">SetParamsClassKnn</span><span data-if="python" style="display:none;">set_params_class_knn</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">set_params_class_knn</span><span data-if="c" style="display:none;">T_set_params_class_knn</span><span data-if="cpp" style="display:none;">SetParamsClassKnn</span><span data-if="dotnet" style="display:none;">SetParamsClassKnn</span><span data-if="python" style="display:none;">set_params_class_knn</span></code> — Set parameters for k-NN classification.</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>set_params_class_knn</b>( :  : <a href="#KNNHandle"><i>KNNHandle</i></a>, <a href="#GenParamName"><i>GenParamName</i></a>, <a href="#GenParamValue"><i>GenParamValue</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>T_set_params_class_knn</b>(const Htuple <a href="#KNNHandle"><i>KNNHandle</i></a>, const Htuple <a href="#GenParamName"><i>GenParamName</i></a>, const Htuple <a href="#GenParamValue"><i>GenParamValue</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>SetParamsClassKnn</b>(const HTuple&amp; <a href="#KNNHandle"><i>KNNHandle</i></a>, const HTuple&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>)</code></p>
<p>
<code>void <a href="HClassKnn.html">HClassKnn</a>::<b>SetParamsClassKnn</b>(const HTuple&amp; <a href="#GenParamName"><i>GenParamName</i></a>, const HTuple&amp; <a href="#GenParamValue"><i>GenParamValue</i></a>) const</code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>SetParamsClassKnn</b>(<a href="HTuple.html">HTuple</a> <a href="#KNNHandle"><i>KNNHandle</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamName"><i>genParamName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamValue"><i>genParamValue</i></a>)</code></p>
<p>
<code>void <a href="HClassKnn.html">HClassKnn</a>.<b>SetParamsClassKnn</b>(<a href="HTuple.html">HTuple</a> <a href="#GenParamName"><i>genParamName</i></a>, <a href="HTuple.html">HTuple</a> <a href="#GenParamValue"><i>genParamValue</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>set_params_class_knn</b>(<a href="#KNNHandle"><i>knnhandle</i></a>: HHandle, <a href="#GenParamName"><i>gen_param_name</i></a>: Sequence[str], <a href="#GenParamValue"><i>gen_param_value</i></a>: Sequence[Union[int, float, str]]) -&gt; None</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p><code><span data-if="hdevelop" style="display:inline">set_params_class_knn</span><span data-if="c" style="display:none">set_params_class_knn</span><span data-if="cpp" style="display:none">SetParamsClassKnn</span><span data-if="com" style="display:none">SetParamsClassKnn</span><span data-if="dotnet" style="display:none">SetParamsClassKnn</span><span data-if="python" style="display:none">set_params_class_knn</span></code> sets parameters for the classification
of the K-最近邻 (k-NN) classifier <a href="#KNNHandle"><i><code><span data-if="hdevelop" style="display:inline">KNNHandle</span><span data-if="c" style="display:none">KNNHandle</span><span data-if="cpp" style="display:none">KNNHandle</span><span data-if="com" style="display:none">KNNHandle</span><span data-if="dotnet" style="display:none">KNNHandle</span><span data-if="python" style="display:none">knnhandle</span></code></i></a>.
It controls the behavior of <a href="classify_class_knn.html"><code><span data-if="hdevelop" style="display:inline">classify_class_knn</span><span data-if="c" style="display:none">classify_class_knn</span><span data-if="cpp" style="display:none">ClassifyClassKnn</span><span data-if="com" style="display:none">ClassifyClassKnn</span><span data-if="dotnet" style="display:none">ClassifyClassKnn</span><span data-if="python" style="display:none">classify_class_knn</span></code></a>.
</p>
<p>The value of <i><span data-if="hdevelop" style="display:inline">'k'</span><span data-if="c" style="display:none">"k"</span><span data-if="cpp" style="display:none">"k"</span><span data-if="com" style="display:none">"k"</span><span data-if="dotnet" style="display:none">"k"</span><span data-if="python" style="display:none">"k"</span></i> can be set via <a href="#GenParamName"><i><code><span data-if="hdevelop" style="display:inline">GenParamName</span><span data-if="c" style="display:none">GenParamName</span><span data-if="cpp" style="display:none">GenParamName</span><span data-if="com" style="display:none">GenParamName</span><span data-if="dotnet" style="display:none">genParamName</span><span data-if="python" style="display:none">gen_param_name</span></code></i></a> and
<a href="#GenParamValue"><i><code><span data-if="hdevelop" style="display:inline">GenParamValue</span><span data-if="c" style="display:none">GenParamValue</span><span data-if="cpp" style="display:none">GenParamValue</span><span data-if="com" style="display:none">GenParamValue</span><span data-if="dotnet" style="display:none">genParamValue</span><span data-if="python" style="display:none">gen_param_value</span></code></i></a>. Increasing <i><span data-if="hdevelop" style="display:inline">'k'</span><span data-if="c" style="display:none">"k"</span><span data-if="cpp" style="display:none">"k"</span><span data-if="com" style="display:none">"k"</span><span data-if="dotnet" style="display:none">"k"</span><span data-if="python" style="display:none">"k"</span></i> also increases the accuracy
of the resulting neighbors and increases the run time.
</p>
<p>The results can either be the determined class of the feature vector or
the indices of the nearest neighbors. The result behavior
can be selected with <code><span data-if="hdevelop" style="display:inline">set_params_class_knn</span><span data-if="c" style="display:none">set_params_class_knn</span><span data-if="cpp" style="display:none">SetParamsClassKnn</span><span data-if="com" style="display:none">SetParamsClassKnn</span><span data-if="dotnet" style="display:none">SetParamsClassKnn</span><span data-if="python" style="display:none">set_params_class_knn</span></code> via the generic parameters
<i><span data-if="hdevelop" style="display:inline">'method'</span><span data-if="c" style="display:none">"method"</span><span data-if="cpp" style="display:none">"method"</span><span data-if="com" style="display:none">"method"</span><span data-if="dotnet" style="display:none">"method"</span><span data-if="python" style="display:none">"method"</span></i> and <i><span data-if="hdevelop" style="display:inline">'max_num_classes'</span><span data-if="c" style="display:none">"max_num_classes"</span><span data-if="cpp" style="display:none">"max_num_classes"</span><span data-if="com" style="display:none">"max_num_classes"</span><span data-if="dotnet" style="display:none">"max_num_classes"</span><span data-if="python" style="display:none">"max_num_classes"</span></i>:
</p>
<dl class="generic">

<dt><b><i><span data-if="hdevelop" style="display:inline">'classes_distance'</span><span data-if="c" style="display:none">"classes_distance"</span><span data-if="cpp" style="display:none">"classes_distance"</span><span data-if="com" style="display:none">"classes_distance"</span><span data-if="dotnet" style="display:none">"classes_distance"</span><span data-if="python" style="display:none">"classes_distance"</span></i>:</b></dt>
<dd><p>
 returns the nearest samples
for each of maximally <i><span data-if="hdevelop" style="display:inline">'max_num_classes'</span><span data-if="c" style="display:none">"max_num_classes"</span><span data-if="cpp" style="display:none">"max_num_classes"</span><span data-if="com" style="display:none">"max_num_classes"</span><span data-if="dotnet" style="display:none">"max_num_classes"</span><span data-if="python" style="display:none">"max_num_classes"</span></i> different classes,
if they have a representative in the nearest  <i><span data-if="hdevelop" style="display:inline">'k'</span><span data-if="c" style="display:none">"k"</span><span data-if="cpp" style="display:none">"k"</span><span data-if="com" style="display:none">"k"</span><span data-if="dotnet" style="display:none">"k"</span><span data-if="python" style="display:none">"k"</span></i> neighbors.
The results are classes sorted by their minimal
distance. There is no efficient way to determine in a
k-NN-tree the nearest neighbor for exactly <i><span data-if="hdevelop" style="display:inline">'max_num_classes'</span><span data-if="c" style="display:none">"max_num_classes"</span><span data-if="cpp" style="display:none">"max_num_classes"</span><span data-if="com" style="display:none">"max_num_classes"</span><span data-if="dotnet" style="display:none">"max_num_classes"</span><span data-if="python" style="display:none">"max_num_classes"</span></i>
classes.
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'classes_frequency'</span><span data-if="c" style="display:none">"classes_frequency"</span><span data-if="cpp" style="display:none">"classes_frequency"</span><span data-if="com" style="display:none">"classes_frequency"</span><span data-if="dotnet" style="display:none">"classes_frequency"</span><span data-if="python" style="display:none">"classes_frequency"</span></i>:</b></dt>
<dd><p>
 counts the occurrences of certain
classes among the nearest <i><span data-if="hdevelop" style="display:inline">'k'</span><span data-if="c" style="display:none">"k"</span><span data-if="cpp" style="display:none">"k"</span><span data-if="com" style="display:none">"k"</span><span data-if="dotnet" style="display:none">"k"</span><span data-if="python" style="display:none">"k"</span></i> neighbors and returns the occurrent
classes sorted by their relative frequency that is
returned, too. Again, maximally <i><span data-if="hdevelop" style="display:inline">'max_num_classes'</span><span data-if="c" style="display:none">"max_num_classes"</span><span data-if="cpp" style="display:none">"max_num_classes"</span><span data-if="com" style="display:none">"max_num_classes"</span><span data-if="dotnet" style="display:none">"max_num_classes"</span><span data-if="python" style="display:none">"max_num_classes"</span></i>
values are returned.
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'classes_weighted_frequencies'</span><span data-if="c" style="display:none">"classes_weighted_frequencies"</span><span data-if="cpp" style="display:none">"classes_weighted_frequencies"</span><span data-if="com" style="display:none">"classes_weighted_frequencies"</span><span data-if="dotnet" style="display:none">"classes_weighted_frequencies"</span><span data-if="python" style="display:none">"classes_weighted_frequencies"</span></i>:</b></dt>
<dd><p>

counts the occurrences of certain classes among the
nearest <i><span data-if="hdevelop" style="display:inline">'k'</span><span data-if="c" style="display:none">"k"</span><span data-if="cpp" style="display:none">"k"</span><span data-if="com" style="display:none">"k"</span><span data-if="dotnet" style="display:none">"k"</span><span data-if="python" style="display:none">"k"</span></i> neighbors and returns the occurrent classes sorted
by their relative frequency weighted with the
average distance that is returned, too.
Again, maximally <i><span data-if="hdevelop" style="display:inline">'max_num_classes'</span><span data-if="c" style="display:none">"max_num_classes"</span><span data-if="cpp" style="display:none">"max_num_classes"</span><span data-if="com" style="display:none">"max_num_classes"</span><span data-if="dotnet" style="display:none">"max_num_classes"</span><span data-if="python" style="display:none">"max_num_classes"</span></i> values are returned.
</p></dd>

<dt><b><i><span data-if="hdevelop" style="display:inline">'neighbors_distance'</span><span data-if="c" style="display:none">"neighbors_distance"</span><span data-if="cpp" style="display:none">"neighbors_distance"</span><span data-if="com" style="display:none">"neighbors_distance"</span><span data-if="dotnet" style="display:none">"neighbors_distance"</span><span data-if="python" style="display:none">"neighbors_distance"</span></i>:</b></dt>
<dd><p>
 returns the indices of the nearest
<i><span data-if="hdevelop" style="display:inline">'k'</span><span data-if="c" style="display:none">"k"</span><span data-if="cpp" style="display:none">"k"</span><span data-if="com" style="display:none">"k"</span><span data-if="dotnet" style="display:none">"k"</span><span data-if="python" style="display:none">"k"</span></i> neighbors and the distances.
</p></dd>
</dl>
<p>
The default behavior is <i><span data-if="hdevelop" style="display:inline">'classes_distance'</span><span data-if="c" style="display:none">"classes_distance"</span><span data-if="cpp" style="display:none">"classes_distance"</span><span data-if="com" style="display:none">"classes_distance"</span><span data-if="dotnet" style="display:none">"classes_distance"</span><span data-if="python" style="display:none">"classes_distance"</span></i>.
</p>
<p>The option <i><span data-if="hdevelop" style="display:inline">'num_checks'</span><span data-if="c" style="display:none">"num_checks"</span><span data-if="cpp" style="display:none">"num_checks"</span><span data-if="com" style="display:none">"num_checks"</span><span data-if="dotnet" style="display:none">"num_checks"</span><span data-if="python" style="display:none">"num_checks"</span></i> allows to set the number of maximal runs
through the trees. The parameter has to be positive and the default value is
<i>32</i>. The higher this value is, the more accurate the results will be.
As a trade-off, the running time will also be higher. Setting this parameter
to <i>0</i> triggers an exact search.
</p>
<p>The option <i><span data-if="hdevelop" style="display:inline">'epsilon'</span><span data-if="c" style="display:none">"epsilon"</span><span data-if="cpp" style="display:none">"epsilon"</span><span data-if="com" style="display:none">"epsilon"</span><span data-if="dotnet" style="display:none">"epsilon"</span><span data-if="python" style="display:none">"epsilon"</span></i> allows to set a stop criteria if the value
is increased from the default value 0.0.
The higher the value is set, the less accurate results of the
estimated neighbors can be expected, while it might speed up the search.</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<p>This operator modifies the state of the following input parameter:</p>
<ul><li><a href="#KNNHandle"><span data-if="hdevelop" style="display:inline">KNNHandle</span><span data-if="c" style="display:none">KNNHandle</span><span data-if="cpp" style="display:none">KNNHandle</span><span data-if="com" style="display:none">KNNHandle</span><span data-if="dotnet" style="display:none">KNNHandle</span><span data-if="python" style="display:none">knnhandle</span></a></li></ul>
<p>During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.</p>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="KNNHandle" class="parname"><b><code><span data-if="hdevelop" style="display:inline">KNNHandle</span><span data-if="c" style="display:none">KNNHandle</span><span data-if="cpp" style="display:none">KNNHandle</span><span data-if="com" style="display:none">KNNHandle</span><span data-if="dotnet" style="display:none">KNNHandle</span><span data-if="python" style="display:none">knnhandle</span></code></b> (input_control, state is modified)  </span><span>class_knn <code>→</code> <span data-if="dotnet" style="display:none"><a href="HClassKnn.html">HClassKnn</a>, </span><span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">HHandle</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (handle)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>HHandle</i>)</span><span data-if="c" style="display:none"> (<i>handle</i>)</span></span>
</div>
<p class="pardesc">Handle of the k-NN classifier.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="GenParamName" class="parname"><b><code><span data-if="hdevelop" style="display:inline">GenParamName</span><span data-if="c" style="display:none">GenParamName</span><span data-if="cpp" style="display:none">GenParamName</span><span data-if="com" style="display:none">GenParamName</span><span data-if="dotnet" style="display:none">genParamName</span><span data-if="python" style="display:none">gen_param_name</span></code></b> (input_control)  </span><span>string-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[str]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Names of the generic parameters that can be adjusted
for the k-NN classifier.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">['method','k','max_num_classes']</span>
    <span data-if="c" style="display:none">["method","k","max_num_classes"]</span>
    <span data-if="cpp" style="display:none">["method","k","max_num_classes"]</span>
    <span data-if="com" style="display:none">["method","k","max_num_classes"]</span>
    <span data-if="dotnet" style="display:none">["method","k","max_num_classes"]</span>
    <span data-if="python" style="display:none">["method","k","max_num_classes"]</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'epsilon'</span><span data-if="c" style="display:none">"epsilon"</span><span data-if="cpp" style="display:none">"epsilon"</span><span data-if="com" style="display:none">"epsilon"</span><span data-if="dotnet" style="display:none">"epsilon"</span><span data-if="python" style="display:none">"epsilon"</span>, <span data-if="hdevelop" style="display:inline">'k'</span><span data-if="c" style="display:none">"k"</span><span data-if="cpp" style="display:none">"k"</span><span data-if="com" style="display:none">"k"</span><span data-if="dotnet" style="display:none">"k"</span><span data-if="python" style="display:none">"k"</span>, <span data-if="hdevelop" style="display:inline">'max_num_classes'</span><span data-if="c" style="display:none">"max_num_classes"</span><span data-if="cpp" style="display:none">"max_num_classes"</span><span data-if="com" style="display:none">"max_num_classes"</span><span data-if="dotnet" style="display:none">"max_num_classes"</span><span data-if="python" style="display:none">"max_num_classes"</span>, <span data-if="hdevelop" style="display:inline">'method'</span><span data-if="c" style="display:none">"method"</span><span data-if="cpp" style="display:none">"method"</span><span data-if="com" style="display:none">"method"</span><span data-if="dotnet" style="display:none">"method"</span><span data-if="python" style="display:none">"method"</span>, <span data-if="hdevelop" style="display:inline">'num_checks'</span><span data-if="c" style="display:none">"num_checks"</span><span data-if="cpp" style="display:none">"num_checks"</span><span data-if="com" style="display:none">"num_checks"</span><span data-if="dotnet" style="display:none">"num_checks"</span><span data-if="python" style="display:none">"num_checks"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="GenParamValue" class="parname"><b><code><span data-if="hdevelop" style="display:inline">GenParamValue</span><span data-if="c" style="display:none">GenParamValue</span><span data-if="cpp" style="display:none">GenParamValue</span><span data-if="com" style="display:none">GenParamValue</span><span data-if="dotnet" style="display:none">genParamValue</span><span data-if="python" style="display:none">gen_param_value</span></code></b> (input_control)  </span><span>number-array <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">Sequence[Union[int, float, str]]</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer / </span><span data-if="hdevelop" style="display:inline">real / </span><span data-if="hdevelop" style="display:inline">string)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long / </span><span data-if="dotnet" style="display:none">double / </span><span data-if="dotnet" style="display:none">string)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i> / </span><span data-if="cpp" style="display:none">double / </span><span data-if="cpp" style="display:none">HString)</span><span data-if="c" style="display:none"> (<i>Hlong</i> / </span><span data-if="c" style="display:none">double / </span><span data-if="c" style="display:none">char*)</span></span>
</div>
<p class="pardesc">Values of the generic parameters that can be adjusted
for the k-NN classifier.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">['classes_distance',5,1]</span>
    <span data-if="c" style="display:none">["classes_distance",5,1]</span>
    <span data-if="cpp" style="display:none">["classes_distance",5,1]</span>
    <span data-if="com" style="display:none">["classes_distance",5,1]</span>
    <span data-if="dotnet" style="display:none">["classes_distance",5,1]</span>
    <span data-if="python" style="display:none">["classes_distance",5,1]</span>
</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span><span data-if="hdevelop" style="display:inline">'classes_distance'</span><span data-if="c" style="display:none">"classes_distance"</span><span data-if="cpp" style="display:none">"classes_distance"</span><span data-if="com" style="display:none">"classes_distance"</span><span data-if="dotnet" style="display:none">"classes_distance"</span><span data-if="python" style="display:none">"classes_distance"</span>, <span data-if="hdevelop" style="display:inline">'classes_frequency'</span><span data-if="c" style="display:none">"classes_frequency"</span><span data-if="cpp" style="display:none">"classes_frequency"</span><span data-if="com" style="display:none">"classes_frequency"</span><span data-if="dotnet" style="display:none">"classes_frequency"</span><span data-if="python" style="display:none">"classes_frequency"</span>, <span data-if="hdevelop" style="display:inline">'classes_weighted_frequencies'</span><span data-if="c" style="display:none">"classes_weighted_frequencies"</span><span data-if="cpp" style="display:none">"classes_weighted_frequencies"</span><span data-if="com" style="display:none">"classes_weighted_frequencies"</span><span data-if="dotnet" style="display:none">"classes_weighted_frequencies"</span><span data-if="python" style="display:none">"classes_weighted_frequencies"</span>, <span data-if="hdevelop" style="display:inline">'neighbors_distance'</span><span data-if="c" style="display:none">"neighbors_distance"</span><span data-if="cpp" style="display:none">"neighbors_distance"</span><span data-if="com" style="display:none">"neighbors_distance"</span><span data-if="dotnet" style="display:none">"neighbors_distance"</span><span data-if="python" style="display:none">"neighbors_distance"</span>, 32, 0.0, 0.02, 0, 1, 2, 3, 4, 5, 6</p>
</div>
<h2 id="sec_result">结果</h2>
<p>如果参数均有效，算子 <code><span data-if="hdevelop" style="display:inline">set_params_class_knn</span><span data-if="c" style="display:none">set_params_class_knn</span><span data-if="cpp" style="display:none">SetParamsClassKnn</span><span data-if="com" style="display:none">SetParamsClassKnn</span><span data-if="dotnet" style="display:none">SetParamsClassKnn</span><span data-if="python" style="display:none">set_params_class_knn</span></code>
返回值 <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
    . 如有必要，将引发异常。</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="train_class_knn.html"><span data-if="hdevelop" style="display:inline">train_class_knn</span><span data-if="c" style="display:none">train_class_knn</span><span data-if="cpp" style="display:none">TrainClassKnn</span><span data-if="com" style="display:none">TrainClassKnn</span><span data-if="dotnet" style="display:none">TrainClassKnn</span><span data-if="python" style="display:none">train_class_knn</span></a></code>, 
<code><a href="read_class_knn.html"><span data-if="hdevelop" style="display:inline">read_class_knn</span><span data-if="c" style="display:none">read_class_knn</span><span data-if="cpp" style="display:none">ReadClassKnn</span><span data-if="com" style="display:none">ReadClassKnn</span><span data-if="dotnet" style="display:none">ReadClassKnn</span><span data-if="python" style="display:none">read_class_knn</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="classify_class_knn.html"><span data-if="hdevelop" style="display:inline">classify_class_knn</span><span data-if="c" style="display:none">classify_class_knn</span><span data-if="cpp" style="display:none">ClassifyClassKnn</span><span data-if="com" style="display:none">ClassifyClassKnn</span><span data-if="dotnet" style="display:none">ClassifyClassKnn</span><span data-if="python" style="display:none">classify_class_knn</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="create_class_knn.html"><span data-if="hdevelop" style="display:inline">create_class_knn</span><span data-if="c" style="display:none">create_class_knn</span><span data-if="cpp" style="display:none">CreateClassKnn</span><span data-if="com" style="display:none">CreateClassKnn</span><span data-if="dotnet" style="display:none">CreateClassKnn</span><span data-if="python" style="display:none">create_class_knn</span></a></code>, 
<code><a href="read_class_knn.html"><span data-if="hdevelop" style="display:inline">read_class_knn</span><span data-if="c" style="display:none">read_class_knn</span><span data-if="cpp" style="display:none">ReadClassKnn</span><span data-if="com" style="display:none">ReadClassKnn</span><span data-if="dotnet" style="display:none">ReadClassKnn</span><span data-if="python" style="display:none">read_class_knn</span></a></code>, 
<code><a href="get_params_class_knn.html"><span data-if="hdevelop" style="display:inline">get_params_class_knn</span><span data-if="c" style="display:none">get_params_class_knn</span><span data-if="cpp" style="display:none">GetParamsClassKnn</span><span data-if="com" style="display:none">GetParamsClassKnn</span><span data-if="dotnet" style="display:none">GetParamsClassKnn</span><span data-if="python" style="display:none">get_params_class_knn</span></a></code>
</p>
<h2 id="sec_references">References</h2>
<p>

Marius Muja, David G. Lowe: “Fast Approximate Nearest Neighbors with
Automatic Algorithm Configuration”;
International Conference on Computer Vision Theory
and Applications (VISAPP 09); 2009. 
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
